ATTR Syntax: Attr filename [permissions] Usage : Examine or 
change the security permissions of a file Opts: -perm = turn off 



specified 
inhibi 
s - nc 
to owi 
pw - 
Syntax 
one d< 
single 
BasicO 
filenti 
CHD S 
specif 



permission perm= turn on 
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Usage 
Syntax 
Syntax 
one fil 
Date ft 
specify 
: Checl 
for woi 
= save 
cluster 
Tint 
<devn 
lenan 
delete 
directo 

w w 

names 
executi 
Display ! 



specified permission -a = 
rms : d - directory file 
: to owner w - write permit 
Ij^'-rr read permit to public 
M: permit to public BACKUP 
ige % Copies all data from 
WM. error occurs s = 

Hites BASIC09 Syntax : 
ge -BUILD Syntax: * Build 
es from standard input 
||p working directory to 
$sa^e: Change execution 
Filename! filenames 
ax: Cobbler devname 
Creates US- 9 bootstrap file from current boot CONFIG 
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disks COPY 
data from 

BssSyntax : 
tfs: t = 
Usage 
ctory 
s -m 
lliunused 

Jit"" = 

lei [-x] 

■iti£-x = 

lax: Dir 
file 

pl|[=print 
jt|;|sUsage : 
^^^m^^S^^^m^^^^^M^m Syntax 



■Ajayvt-mii f\ 



^ i-n J ftwfcl' — £ 



^ *****-» 1 rfcTTrtl 



Dsave [-o$tl|p^ file 

to copy all files in a directory system Opts : -b make a system 
disk by using 0S9boot if present -b=<path> = make system disk 
using pat 
process b 
command 
ECHO Syn 
output EC 
text edito 



MARCH 1990 



l do not 
makdir 

o-uwm K 

HHard 

slllnted 

error messag^|^Mipf^^pi|M W^^^^^W^^W^^^^> 
Us ag e ; Chain 1^ ' liie' f 

<devname> Usage : Initializes an OS-9 diskette Opts ; R - Ready L 
- Logical format only "disk name 1 ' 1/2 number of sides 'No of 
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The new graphics which appears above is the handywork of one of our members, Peter Hughes. Peter designed this to 
oe used as a letterhead for user group correspondence, and I think it looks great. Peter suggested that we include 
this sample and invite comment or other submissions or ideas. We also have a coloured version produced gh Peter's 
colour printer, and he plans to photograph the CoCoMax screen so that we can have this logo printed onto T shirts. 
I believe there are a number of places that will enlarge a colour photo and print it en your T shirt for around $12 

Perhaps you could let us know if you would be interested in such a T-shirt, not that we want to go into business in 
this area, but we should be able to arrange a purchase deal somewhere which would enable us to supply printed T- 
shirts &t a reasonable price. Does anybody have a contact in this area? What do you think? 

The membership of the National OS-9 group continues to increase. Currently, membership stands at fifty three (53) 
with a couple of other recent enquiries. In this newsletter we provide information, program listings and reviews 
of hardware and software. We will also include advertisements free to our members, no we will not accept paid adds 
from commercial enterprises or businesses, but may include information about products available where we feel this 
would be of service to our members. 

we will also include a Trading Post section if you have computer hardware or software for sale, or if you would 
like us to list something in the 3 Wanted a category. Any software listed for sale MUST of course be an Original 
issue for which, you have a legal right to seii. 

The CoCo4 s- We have a little more information on the rumoured CoCo4 which comes to us via a system variously 

called News or Netnews. This is sort of like a global bulletin board. The letters are broadcast across the 

network for inspection by anyone who wants to do so. Two of the relevant newsgroups are a comp.os.os9 B and 
"comp.sys.iSB?". 

It appears that there are TWO independent projects underway to produce a cheap 68k/68B9 computer using 0S9, and 
retaining compatibility with CoCo 0S9 (but not RSDOS). 1 have been advised very recently that one of these 
projects are being undertaken by Frank Hogg Labs. Another item gleaned from the list is that the 0S9 super-guru 
Kevin Darling, with others, is producing an upgrade to CoCo Level 2 0S9, and this should be reacy in the ne>!t few 
months. This effort is independent of Tandy and Microware, both of whom have given up on the CcCo. 

At least one of the CoCo4 projects is being reierr^ to as the KMA/CC4, not sure of the origin of the a KHA a but 
someone on the NET suggested it was "Kill Host Amigas/Atar is/Apples'. 

The following is a posting to the Net by Kevin Darling, dated Jan 17th 1990, 

"Friends, I've been reading the list, but too busy to answer each time. So 1 thought I 7 d throw everything in at 
once <gnn>. 

KMA/CC4 - There are still two machines being worked on. details/diffs unfortunately cannot be released yet because 
aach company is in competition with the other} and at least one is clamming up. In fairness I'll therefore await 
their permission. (BTW, that goes for L-II upgrade speculations... just be patient and be wary of "facts.) 

However, some features on each/both machines should be mentioned in order to answer some comments/speculations made 
on the nets. 
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Any 6809 card would have a header for plugging in Disto's one-meg upgrade cpu board. There might indeed be sockets 
for the extra RAM, but do not forget that the main $$ part of that upgrade is the cpu board which has the external 
DAT to extend the GIME's MMU. Sockets alone are not enough 1 ! Sure, a 1— meg DAT could be built onto the 6309 card, 
but they see no reason to zap Disto's market, nor to force people to throw away a one-meg upgrade kit they may 
already have bought, NOR to make someone pay extra for something they might not want/need. 

Re: comparisons to the Amiga. I own one. It would make a nice 0S9 machine, but its not easily expandable (except 
the A20B0), and doesn't have a standard floppy controller. Under AmigaDOS, the minimum useable system is 1-meg and 
two drives anyway, which is about $1030 for an A500, Go to a 6B320/03B and we're talking A2000 and a total $4500! 
That's affordable? 

Compare that to one of the KMAs selling for under $600* with 320-256 color mode ($300 extra on the Amiga), 642-16 
color mode, DMA stereo output AND inputs (extra $$ on Amiga)? using IBM serial mouse and/or your old CoCo mouse, 
CoCo joysticks, hidens IBM-style (read: normal) disk controller, MIDI port, dual serial/parallel ports, and OB? in 
ROM, Plus optional 68020/030 cards for a couple of thousand less than the equivalent optional Amiga card. And a 
bus-based architecture for limitless expansion. 

Sure? the Amiga has a glitter right now, That helps at times. On the other hand, their programs "cheat" and 
directly manipulate screen memory. Which means that they cannot move to machines where the video is handled 
TOTALLY away from the main cpu, by ANOTHER cpu dedicated to such a task... such as you'll be able to do with the 
KMA. Nor are they able to upgrade to future video cards that might have e 43020 or other hot gfx chip. Etc Etc. 
Their hardware is falling way behind now however, and they know it. 

0S9ers are willing to take the long view. Many programs written almost 10 years ago, and they know that most will 
still work 10 years form now, even as the hardware art advances (which it most assuredly does and will). If you're 
into instant and temporary gratification, get a Nintendo for your games, and a PClone for biz programs. That's 
perfectly fine. Your 059 machine will continue as your link to the future; an understandable and lovable link, at 
that. Best to all - Kevin" (end quote) 



Another posting to the NET that might be of interest, dated Dec 7th 19B9 and posted by Mike Knudsen ;- 
"KMA... The motherboard wiii have plug-in sockets for four cards, each optional (more or less) at extra cost: 

(1) 6809 with GIME and 512k RAM to run CoCo3 0S9L2 programs. Actually the GIME is an empty socket — you steal 
your CoCo3 : s GIME and plug it in 1 This gets around Tandy legal problems (boy will they get a lot of GIME "repair 
part* orders). 

Likewise the RAM area is empty, and you plug in your stock Tandy or 3rd-party 512k daughter board on that. And I 
assume your DISTO 1-meg if ya got it. Probably this board also has some stock CoCo peripheral hardware — R3232, 
mouse/stick, and a socket to stick your disk controller or MP I into. 

(2) SCSI interface board for floppy and hard drives, with DMA. This is for the 68k side, but might also be 
useable by the 6809 for users who don't already have disk controllers or who want the extra no-halt DMA 
performance. 

(3) 68070 board with the Phillips VSC chip. If you get this you must take OSK, probably in ROM. Maybe you have 
to take this board and OSK to buy a CoCoPro at all. The political motivation here is to get us all to move to OSK, 
so you get it whether you want it or not. Anybody here really not want it? Aw c : 'mon... 

Not clear whether you can plug your old 512k boards into this one. All video outputs and modes will be included. 

Hopefully you can switch between 0S9 and OSK windows with the good old CLEAR key. Early on, this board will be 

able to take L2 window gram ESCape commands from the 6809. I expect this will wean UltiMuse away from the VDG 
screens at last, and MVCanvas will be a pleasure to operate. 

The big board will mount in a PC case and use a PC keyboard and power supply. It seems that the different daughter 
boards can share some of the memory space. That's it for now — Mike K. E (end quote) 

So there is something to think about for- this month. If and when, we see a CoCo4, KMA or whatever, here in 
Australia, only time will tell. Regards, Gordon Bentzen 
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TAX, INCOME and INVESTMENT. 
A spreadsheet template by David Eaton. 

Editor's Note:- This Dynacalc Spreadsheet template and the accompanying article have come to us from David 
Eaton from Canberra. It is articles like this that will keep this newsletter going. Thank you very much? David. 

Aim of the Fr ograrame 

This Dynacaic programme is designed tc:- 

(1) Summarise all necessary information for preparation of Income Tax returns for my wife and myself. 

\2) Summarise Total Income including reinvestments and compare actual Cash Receipts with Budgeted Cash 
Receipts. 

(3) Show Investment movements during the year and summarise the nett change in Investment. 

Listings 

There are two listings:- 

The first listing is the plan or design on which the programme is based? the second listing shows the headings 
and the first two rows of an actual tabulation for a specific year. The first row shows the formula used in 
place of actual values where this is possible ( i.e. where the values are calculated by formulae and are nor 
directly entered values.) 

Detailed Comments column by column 

Coluan A 

The first column is headed H T k or Housekeeping? which is a term I use for a column containing Indices to be 
used in '3IFO' formulae in the body of the programme, In this case 7 S T signifies income in my name? and '1' 
income in my wife's name. 

Coluums BCD 

Three columns used to contain a description of the Income Source e.g. name of investment. 

Column E 

Number of units in a Trust, number of shares in a Company or nominal value of a fixed Investment. 

Colusn FSil 

Provides four columns for entry of up to four payments a year from an income source. More or less columns can 
be provided as necessary. Enter all receipts whether income received in cash or reinvested. Exceptions are 
Medicare payments and income tax payments. Cash or credit from sale or maturity of investments should be 
included. 

Coluflm J 

Sum of the previous four columns using 'SSUM(F>;. ..Ixr where ? >r stands for row number. This formula can be 
replicated down the column as required. 
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Column K 

Enter values for investments sold or reaching maturity. 

Colunn L 

Current income. Jx-Kx 

Column H 

Dividends or other income reinvested* 

Column N 

This is the actual cash income received. The formula J>;-Kx-Mx represents total income less sales and 
reinvestment. 

Column 

Budget Receipts^ calculated from the previous year modified for any known changes. 

Column P 

For salary or superannuation tax is deducted at source. Enter here. 

Column Q 

Ta>; free income: some income, e.g. from Property trusts, has a ta>: free component. Enter here. 

Column R 

Input Credits. These are usually shown clearly on the payment slip from the Company or Trust but can be 
calculated. 

Columns ST 

The input credits are allocated to individuals from the formula SIFO 

Column U 

Total taxable income calculated with the formula Jx-Kx+P>:-Qx+Rx. 

Columns W 

Again allocation of tax between individuals. 

Column X 

Any new investment made during the year. 

Column Y 

Nett investment derived from -K>:+Mx+Xx 

Column 1 

Franked investment : Entered from the payment slip from Company Dr Trust. 
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Colum AA 



Unfranked investment ' Required for the income tax return and derived from the formula 3IF ( 2>:>0, J>j-Kx-Z>: , ) , 
This is not used in calculating taxable income. 

INCOME, TAX AND INVESTMENT 



Col 


Column Heading 


Formula or 


v'aiue 


Description ! 


A 


House Keeping 


3 or 1 




3 for TDEi 1 for DGE 


BCD 


Item 


Name 




Income Source ! 


E 


Nos or Norn value 


Number 




Number of Units or 1 
Nominal Value i 


F5HI 


Income Received 


Values 




All monies received or i 
credited ! 


J 


Total Income 


3SUM(Fk...I 


r 1 1 


Total receipts and credits i 


K 


Sold 


Values 




Investments sold or ! 
reaching maturity ! 


L 


Nett Income 


Jx-Kx 




Current Income ! 


M 


Reinvestment 


Values 




Dividends or other income ! 
reinvested ! 


N 


Nett Receipts 


Jx-Kx-Mx 




Actual cash income 1 





Budget Receipts 


Values 




Previous Year's Income ! 
with known changes ! 





Tax Deducted 


Values 




Tax deducted at source ! 


Q 


Tax ?rep Income 


Values 




Shown on payment slip ! 


p t 


Input Credits 


\2x/.6i)*.39 


Preferably use figure ! 










given by Company ! 


S 


Input CR DSE 


3IF(Ax=l,Rx 


,3) 


Individual input credits ! 


T 


Input CR TDE 


SIF(Ax=0»Rx 


»a> 


Individual input credits ! 


U 


ictai !aXBDis 


Jk-Kk+Ps-Qx 


^Rx 


Total Taxaole Income ! 


V 


Ttl Taxable DGE 


3IF<Ax=I,Ux 


,3) 


Individual Tax Total ! 


W 


Tti Taxable TDE 


5IF(Ax=0 T Ux 


il) 


Individual Tax Total ! 


X 


New Investment 


Values 




Investment during year ! 


Y 


Nett Investment 


-Kx+Mx+Xx 




Nett increase or decrease ! 


2 


Franked Invest 


Values 




From dividend slip ! 


AA 


Unfranked Inv 


3IF(2x>0,Jx-K 


*-Z>:,0) ! 


Required for Income Tax ! 
Return ! 
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General Comments 

Four columns are provided for Income Received (Columns FGHI), but only one column for Tax Deducted or Input 
Credits though a number of entries may be necessary during the year. Dynacak provides a neat way of adding new 
entries tc existing ones by typing '#+new entry 7 [where 'new entry- is the new value to add (Ed)). Extra columns 
can be added if desired, but I have tried not to make the tabulation too unwieldy. 

Sub headings can be provided in the 'Item* column corresponding tc those used on the Income Ta>: return, 
e.g. Fixed Interest, Equity, Trusts. 

This programme has been developed to meet my own specific need: other people will have different needs, but 
maybe this programme will help to give them a flying start in developing their own answers, 

David Eaton. 

IWCanvas 

a software review 

by Bob Devries 

Package. MVCanvas 

Source : Game Point Software 

PO Box 6907 

Eurbank. CA, 91510-6967 

USA 
also : Nick Mar en tes 

PO Box 551 

Garden City 

Qid, 4122 

A$35.BB (Jan T 9B) 

Finally someone has written a drawing programme for 0S9 along the lines of CocoMax III or Col or Max. The 
results of this first real attempt at drawing with pull -down menus and icons and such are very pleasing indeed. The 
programme works under the Multi-Vue system and uses the 'Windlnt' pull-down menus and screens. 

The puii-down menus at the top of the screen are^- 

FILES EDIT GOODIES TOOLS FONT 



Of course the Multi-Vue 
pull -down menu look like this:- 



close gadget' is there at the extreme left of the menu bar. The contents of each 



FILES 



EDI" 



GOODIES 



TOOLS F0N1 



New Canvas- 
Load 

Load IMG 
Save 

Save As... 
Print 
Squash On 
Set Pic Dir 
Set Execute 
Set Printer- 
Directory 
About... 



Undo 

Cut to Disk 

Copy 

Paste 

Clear 

Show 

Invert 

Flip Horizontal 

Flip Vertical 

Load Clip 



Cycle Color 
Cycle Speed 
Swap Color 
Edit Brush 
640x200x4 
Grey Scale 
Load Font 



Font Default 

Plain 

Bold Off 

Transparent Off 

Reverse Off 

Underline Off 

Proportion Off 
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The only menu I have not shorn is the TOOLS menu, because the author? Mike Haaland? has made this a 
graphics buffer with the colours? patterns? and tool icons in it? and it is a bit hard to draw with a text editor. 
The programme performs very well indeed, and Goes everything that the menus suggest. Some items may be a little 
slower than its RSDOS counter-part? but then? RSDOS does not do any multi-tasking either. As I am writing this? I 
have a copy of MVCanvas running in 'Wl 1 which is set up as a graphics window? as weil as which I have a 32x16 VDG 
screen. 

MVCanvas saves and loads 'VEF 7 format files il haven't found out what that stands for yet)? and conversion 
programmes are available to convert from CM3? MGE? DS69 formats to VEF. There are also some public domain 
programmes available to convert GIF files to VEF. MVCanvas will also read files written by Nick Marentes' RASCAN 
Digitiser (IMG) and so allow those people who own those to modify? re-colour? and title pictures from real-life. 

MVCanvas uses standard 0S9 Fonts file? so the files in your 'SYS 7 directory called 'stdfonts' could be 
used. There are also a few fonts converted from the RSDOS Graphicom II programme which I converted over to 0S9 
using Kevin Darling's programme from his book 'Inside 0S9 Level IT. I think other fonts files could probably be 
converted also? especially those from? say? CocoMax III. 

To run the programme from a hard disk? it is simply a matter of creating ihe necessary directories for the 
files? and copy all the files to them. MVCanvas has not been hard-coded for ANY directory names? only the file 
'toolbox 1 must be either in the current working directory? or in 7DL7SYS 7 which is not an unreasonable request. If 
the toolbox file is not found? MVCanvas exits cleanly after displaying a message to tell you of the problem. 

The only real problem I had with the programme? was with the printer drivers? none of which worked properly 
with my BMC BX-1000 printer. I feel? however? that this would not affect most people? as this printer is a bit of 
an odd one any-way. Further to this though? Mike Haaiand will write a printer driver for you if your printer is not 
supported? if you send him the details of your printer. 

The TOOLS menu contains these tools icons:- 

SCROLL This allows the editing of the full 322 >; 200 or 640 >: 200 picture. 

TEXT This allows you to print text on the screen in a previously selected font. 

GRAB This allows you to select up to one quarter of the screen for editing purposes? and places it into 
the ClipBoard file. 

FATBITS This allows a magnified view of a selected portion of the screen. 

RADIANS This produces the familiar star shaped patterns. 

LINE produces straight lines of course. 

PENCIL is used for free-hand drawing. 

BAR produces a filled box. 

BOX produces an empty box. 

ELLIPSE produsec an ellipse of any size. 

CIRCLE produces a circle. 

SPRAYCAN sprays dots over the screen. 

FILL fills the selected area with the paint colour. 

BRUSH gives free-hand drawing with a larger tool. 
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STAMPS allows you to make a rubber stamp of an area of the screen so you can copy it to another part of 
your- picture. 

All these tools are represented by pictures (icons) and can be selected by clicking the mouse button while 
pointing to then.. As melU there are sixteen colours and eight patterns to select from. There is also a facility to 
change a palette colour to any one of sixty-four colours. 

I found MVCanvas easy to use, simple to install , and above all* good value for money. I can heartily 
recommend it. 

Bob Devries 

Module identification, 
by Bob Devries. 

Don Berne an I decided that it would be a good idea to print the module i dents of the system modules that 
we are currently using- so that others can see whether they are up to date with their 0S9 versions. These listings 
were produced by IDENT (and then modified to shorten them a little). They are all level two modules. You'll notice 
that some Uaye comments beside ibex regarding modifications and other versions. You'll notice that I have not 
included any Device descriptors, as these will change (and should) with each individual system. 

Header for: 0S9p2 

Module size: $0CAE #3246 

Module CRC: $47£37B (Good) 

Edition: til #17 

Header for: IOHan 

Module size: $09F3 #2547 

Module CRC: 4FD1FEA (Good) 

Edition: $SC #12 



Header for: in it 

Module size: $002E #46 

Module CRC: $680456 (Good) 

Edition: $43 #67 



modified for number of open paths. 



Header for: CC3Gc 

Module size: $01AE #43C 

Module CRC: $1006FE (Good) 

Edition: $05 #5 



Header for: Clock 

Module size: $027F #639 

Module CRC: $ED15E5 (Good) 

Edition: $03 #3 



Special version for CRC SCII with hardware clock. 



Header for: RBF 

Module size: $122E #4654 

Module CRC: $EFBEi3 (Good) 



Edition: 



#26 



Header for: CCHDisk 

Module size: $02FS #752 

Module CRC: $A1199D (Good) 

Edition: $04 #4 



Special version for CRC SCII SASI hard disk interface. 



Header for: CC3Disk 
Module size: $04EA #1256 
Module CRC: SA27877 (Good) 



Special version for CRC SCII No-halt controller 
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Edition: 



$A3 



#163 



Header for: Rammer 

Module sue: $0128 #296 

Module CRC: $15C571 (Good) 

Edition! $03 #3 



Public domain Ramdisk driver, 



Header for: SCF 

Module size: $06AB #1707 

Module CRC: $7E683A (Good) 



Edition) 



#1- 



Modified with Kevin Darling's command line edit functions. 



Header for: CC3I0 

Module size: $0C64 #3172 

Module CRC: 514BA44 (Good) 

Edition: $10 #16 



Patched for some bugs. 



Header for: yindlnt 

Module size: $1D6C #7532 

Module CRC: $744DB8 (Good) 

Edition: $12 #13 



Patched. 



Header for: ACIAPAK 

Module size: $03B5 #949 

Module CRC: $C1EA10 (Good) 

Edition: $0C #12 



Modified to work on CRC SCI I 4 in 1 board RS-232 board. 



Header for: PRINTER 

Module size: 50I7A #378 

Module CRC: $CC3EA4 (Good) 

Edition: $0C #12 



Header for: Parallel 

Module size: $0095 #149 

Module CRC: SA70A4C (Good) 

Edition: $0& #6 



Special parallel printer driver for CRC 4 in i board. 



Header for: VDGint 

Module size: $0CE5 #3301 

Module CRC: $7693A7 (Good) 

Edition: $01 #i 

Header for: PipeMan 

Module size: $0219 #537 

Module CRC: SAD6713 (Good) 

Edition: $04 #4 

Header for: Piper 

Module size: $0023 #40 

Moduie CRC: $5E2B56 (Good) 

Edition: $02 #2 

Header for: Pipe 

Module size: $0026 #33 

Moduie CRC: $CC86AF (Good) 

Edition: $50 #80 
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Header for: Printerr 

hoduie size: $0168 #352 

Module CRC: $830380 (Good) 

Edition: $06 #6 



Modified from Level One. 



Header for: In it 

hoduie size: $8B2E #46 

Hoduie CRC: $BE2322 (Good) 

Edition: $43 #67 



Original LII Version 02.0B.Bi 



Header for: CC3Disk 

Module size: $0454 Si IBS 

hoduie CRC: $759161 (Good) 

Edition: $B9 #9 



Ditto 



Header for: SCF 

Module size: $B5E3 #1507 

Module CRC: $F946CA (Good) 

Edition: $0D #13 



Ditto 



Header for: CC3I0 

Module size: $BC36 #3126 

Module CRC $F737C2 (Good) 

Edition: $10 #16 



Header for: VDGint 

hoduie size: $BCE5 #3301 

hoduie CRC: $HED9B (Good) 

Edition: $0i #1 



Ditto 



Header for: Grflnt 

hoduie size: $0D3D #3389 

Module CRC: $6E4441 (Good) 

Edition: $0E #14 



Ditto 



Header for: ACIAFAK 

Module size: $03B5 #949 

Module CRC: $C1EA1B (Good) 

Edition: $BC #12 



Ditto 



Header for: SIO 

Moduie size: $0185 #339 

Module CRC: $915957 (Good) 

Edition: $39 #9 



Ditto 



Header for: Clock 

Module size: $01£E #494 

Module CRC: $D2SAFD (Good) 

Edition: $09 #9 



Ditto 
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VARIATIONS ON A DISK ZAP SCENE 
INCLUDING MODIFICATIONS TO COCO 0S9 DISK ZAP 

Some other minor bugs in my disk zapper programme ZAP, have come to light. They are not really faults with 
my programming* but rather* result from problems with the way that some of the Easic09 number manipulation 
functions handle large non-integer numbers. 

The version of the disk zapper which is currently circulating throughout xhe user group is starting to get 
"dated"* and these patches will be the last to be made to it, as I can no longer keep supporting that archaic 
version of the code. 

One of my recent projects* with a great deal of help from Sob Devries* has been a major upgrade to this disk 
zapper programme (the newest Version is 1.19)* but still written in Basic09. Amongst the changes made ^re some 
advanced techniques for opening windows* all of the bugs fixed (as far as we know), so that the programme can be 
used on any sized hard disk* a major improvement in the speed at which the programme works (by about 59 ";)* the 
ability to use (automatically) a parallel printer interface* if present and lots of other minor changes. The size 
of the code of the packed version has increased from Hex. 2C47 to Hex. 3937. 

Because of the not inconsiderable time we have invested in the rewrite project* we have decided that we will 
only release the packed version of the programme into the public domain. And therefore* we will only be able to 
distribute it via the National User Group Library. The usual postage and copying fees apply* but you will be able 
to distribute it freely to other users, We are currently working on version 2.00. All future revisions (including 
2.00) will be written in C for even faster operation. 

Improvements and enhancements to the C versions will possibly include an improved user interface (mouse 
driven ?)* logical sector 9 decoding into plain text* a much improved calculator function, the ability to work with 
files and tracks as well as sectors* a means of editing (with reference to files) the sector allocation tables* 
ascii editing of disk sectors* automatic CRC updates* and ail sorts of other goodies. He will even be trying to 
include such things as file undelete functions* the ability to read and repair damaged disks* and perhaps even 
single track formatting!! So keep reading the newsletter* because you will find out about it first in these pages. 

Now for the patches to the original version. Even with these patches* if you have a hard disk* you will 
still not be able to access sectors greater than 5FFFF. Sorry about that, but the changes necessary to this 
version to allow it to be able to do that, ar^ just too involved to justify the space in the newsletter. 

Firstly* there is a problem caused by the way that the VAL function decodes large numbers. 

When a string representing. a number which is larger than 32763 (32K) is passed to VAL* it interprets it as a 
two's complement number* and therefore gets a negative result! Hardly what one needs to reference a sector number 
on a disk. 

Normally* this would never matter, because the maximum number of sectors on an 30 track double sided disk is 
only 2380. On a hard disk however, it is a different matter, My hard drive has 737213 sectors (23 meg) and 
therefore the problem can arise. 

The following changes (marked in boldface) to the Getsec Procedure will avoid the problem* and allow you to 

access sectors from $8008 to ?FFFF. The programme will still "hang 3 if you try to access sectors $10000 and above. 

(Incidentally* the new* packed version doesn't hiccup at all when reading sectors up to $FFFFFF* and that's as far 
as you can go with the current versions of OS? anyway). 

PROCEDURE getsec 
BASE 

PARAM wpath:BYTE 
PARAM maxb!ock:REAL 
PARAH blknosREAL 
PARAM secdat( 256): BYTE 
DIM hblkno:STRINGC25 3 
DIM max0, max l: INTEGER 
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DIM i: INTEGER i* New line inserted *) 

maxB=0 

IF maxfaiock>65535. THEN 

MxB=INT(maxblDck/65536.) <* Note 65535 changed to 65536 *) 

MKi=M0D(fflaxblDck,65536.) <* " ' ■ ■ *) 

ELSE 

ma>;i=ffiax block 

ENDIF 

1 PRINT *wpath,' SECTOR NUMBER iisajs:*'; 

PRINT #wpath USING B K2 b ,ifca>;£; 

PRINT #upath USING 'HASmaxl? 

PRINT #wpath, fl ) :"? 

INPUT #wpath, B Shbikno 

<* hblkno='t"+hblknD «* This line now deleted *) 

ON ERROR GOTO I 

(* blknc^VALthblkno) *** This line now deleted *) 

bkno=S . (* Four *} 

FOR i=LEN(hbIkno) TO 1 STEP -1 (* new *) 

biknD=blkno+vAL( a $ B +HID$(hbiknD,i,i})*i6MLEN(hb!knD}-i} U lines +) 

NEXT i (* inserted *) 

IF blkno>ffia>:biDck OR bikno<0 THEN 

GOTO 1 

ENDIF 

RUN uiincloseiupath) 

END 

All that this modification does is to parse the input hexioecimal string into individual single digit hex 
number s * then uses VAL to decode these to decimal* and then performs the necessary ffiulti plication to derive a real 
number as the final result. 

The second problem stems from the fact that the EasicE9 PRINT USING 'H# fi (where # is a number) function, does 
not reliably decode non-integer numbers, and, as well, cannot handle numbers greater than 65536 £64K). The 
following patches to the Sen Procedure overcomes the problems. 

PROCEDURE sen 

ON ERROR GOTO 10013 

EASE e 

PARAM uipath:BYTE 

PARAM NAME:STRING[4] 

(* PARAM ibikno: INTEGER *) <t Line deleted *) 

PARAH blkno:REAL (* New line inserted *) 

PARAM secdat* 256): BYTE 

DIM COUNT: REAL 

DIM i: INTEGER 

DIM PAGE: BYTE 

DIM outstr:STRINGLi6j 

DIM tblkno(2):INTEffR i* Nev line inserted *) 

PRINT #wpath,CHR$(i(3C} 

PAGE=E \outstr=' B 

COUNT=0 

PRINT #wpath, "DEVICE : fi ; LEFT* (NAME, LEN( NAME} -I); B E l 'SECTOR : $ B ; 

i* PRINT #wpath USING - H4>", ibikno *) (* Line deleted *) 

tblkno<0}=INT(blkno/65536.) (* Four *) 

PRIfTT fapath USING i h2> , ,tblkno<0); <* New *) 

tblknoU>=IWT(HOD<blkno, 65536.)) <* Lines *) 

PRINT fapath USING B h4>",tblknoU); <* Inserted *) 

PRINT Iwpath, 

PRINT #wpath, fl Rel 81234567B9ABCDEF" 
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PRINT topath/Addr 3 

FOR i=0 TO 255 

IF COUNT=0 THEN 

PRINT #wpath USING d h2> a ,PAGE; 

PAGE=PAGE+i 

PRINT #wpath, a fl J 

ENDIF 

PRINT ftwpath USING , h2>',5ecdat(i); 

COUNT=COUNT+i 

IF secdat(i)<*21 OR secdat(ii>$7A THEN 

outstr=outstr+ a . H 

ELSE 

outstr=outstr+CHR$<5ecdat ( i ) ) 

ENDIF 

IF C0UNT=16 THEM 

PRINT Jtopath 

COUNT=0 

ENDIF 

NEXT 1 

PRINT #upath 

END 

1000 RUN closerHwpath) 

END 

You will also need to modify one line in the "tain part of the programme in order to pass the correct sector 
number to the screen print procedure, 

PROCEDURE zap 

11 RUN sen (wpathi NAME T blkno,secdat) i* Parameter name changed iblknc=hlkno *) 

A similar routine within the main procedure is used to print a sector to the printer. Similar changes to 
that parr of the main Procedure are required in order for the print routine to function correctly. I leave it to 
you to make any changes that are required m that part of that Procedure. 

occccooodcOO 0000 OOOOo ooo o oooo a 

• i_ ; ; r--']~i_ i fi i -L'i i!i_i_r 

While on the subject of patches^ the printer gremlins got to the shell script programme that mas published in 
the last version of the newsletter. (I went through and altered one line by hand on every copy :!!), 
Unfortunately i however I missed noticing that another line was also missing. You will need to add the line: 

immediately prior to line 16. (line 16 reads : *Loopi) 

Otherwise T as you may li&ye found out you will have problems finding your files. 

If you have any problems with this shellscript, or the patches irientioned in the article above T please do not 
hesitate to call me. 

Cheers, Don Berrie. (07) 375-3236. 
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